package com.mapper;

import com.bean.BookCategory;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;

@Mapper
public interface BookCategoryMapper {

    /**
     * 根据分类 ID 获取书籍分类信息
     * @param categoryId 分类 ID
     * @return 对应的书籍分类信息，如果未找到则返回 null
     */
    BookCategory getBookCategoryById(Integer categoryId);

    /**
     * 获取所有书籍分类信息
     * @return 包含所有书籍分类信息的列表
     */
    List<BookCategory> getAllBookCategories();

    /**
     * 插入新的书籍分类信息
     * @param bookCategory 要插入的书籍分类信息对象
     * @return 插入操作影响的行数，成功插入返回 1，失败返回 0
     */
    int insertBookCategory(BookCategory bookCategory);

    /**
     * 根据分类 ID 更新书籍分类信息
     * @param bookCategory 包含要更新信息的书籍分类对象，categoryId 用于定位要更新的记录
     * @return 更新操作影响的行数，成功更新返回 1，失败返回 0
     */
    int updateBookCategory(BookCategory bookCategory);

    /**
     * 根据分类 ID 删除书籍分类信息
     * @param categoryId 要删除的分类 ID
     * @return 删除操作影响的行数，成功删除返回 1，失败返回 0
     */
    int deleteBookCategoryById(Integer categoryId);

    /**
     * 分页模糊查询书籍分类信息
     * @param keyword 模糊查询的关键字，可匹配分类名称
     * @param offset 分页偏移量
     * @param limit 每页显示的记录数
     * @return 符合条件的书籍分类信息列表
     */
    List<BookCategory> getBookCategoriesByKeyword(String keyword, int offset, int limit);

    /**
     * 统计符合模糊查询条件的书籍分类数量
     * @param keyword 模糊查询的关键字，可匹配分类名称
     * @return 符合条件的书籍分类数量
     */
    int countBookCategoriesByKeyword(String keyword);
}